Version notes:
   2.2 -- Fixed bug: previous versions would not handle negative 
          temperatures correctly
   2.1 -- Discovered a new forecast: Freezing Rain. Added it. 
   2.0 -- Added support for PointCast version 2.0
   1.1 -- Added better way to get weather from cities with
          two names (the "\s" convention)
       -- Cleaned up documentation a little bit
       -- Figured out that PointCast codes "1" and "3" and "6"
          mean "Fair," "Mostly Cloudy" and "Windy," respectively.
   1.0 -- Initial release.

-----------------------------------------------------------------------

This is "Weather," version 2.2, a set of DOS batch files and a 
freeware program called MiniTrue (MT.EXE) that will take PointCast 
weather information stored on your hard disk and -- with the aid
of the "MAKEDOC.EXE" program from Pat Beirne -- produce a DOC file 
for the USRobotics PalmPilot that contains PointCast weather 
forecasts for the cities of your choice. 

You must have PointCast installed, and MAKEDOC on the path.

-----------------------------------------------------------------------

To run Weather: 
   1. Unzip MTFILES.ZIP.   You only need MT.EXE
   2. Edit GRABWTHR.BAT to be sure that the folder for 
         PointCast weather information is correct for your setup
         (It's different for PointCast ver. 1 and ver. 2, so 
         you have to specify the right folder for the version
         you're using. Read GRABWTHR.BAT--it will explain it.)
   3. Edit CITYLIST.BAT to put in the city names of your choice
   4. Invoke CITYLIST.BAT as a DOS batch file
   5. Install WTHR.PDB, a DOC file with the current weather, by using
      the INSTAPP.EXE program in your Pilot directory/folder.

-----------------------------------------------------------------------

Files in this archive are these:

WEATHER-README.TXT --  This file.

CITYLIST.BAT -- This is the one you call to make it all work.
                Edit the line that starts with GRABWTHR
                to put in the cities you want weather for.
                It works by passing the city names to ...

GRABWTHR.BAT -- You must edit this file to have the right
		folder specified for PointCase. You may edit it 
                to add cities if you want, or you can just put the
                cities in the CITYLIST.BAT file. Either one or
                both will work. 

                GRABWTHR.BAT works by copying the PointCast
                weather file and editing the copy with the 
                program called MiniTrue (MT.EXE) to extract
		the cities you've indicated, then translate
                PointCast's short numeric codes into English. 
		It then runs MAKEDOC on the result.
                MAKEDOC has to be in the same folder or on the path.

AUTOBOOK.TXT -- Put whatever you want to use as an automatic 
                bookmark for Rick Bram's DOC program in between
                angle brackets in this file. If you want to change
                from the default three spaces, you'll also have to
                edit GRABWTHR.BAT where the REMarks tell you to.

MTFILES.ZIP -- This is a freeware program and its docs called "MiniTrue"
               by "Splunge Software" that does sophisticated string 
               search and replace. It's like Unix GREP or PERL 
               scripts (I think). The author describes it this way:

    "MiniTrue is a fast and versatile search/replace utility run from the
DOS command line. MiniTrue synthesizes the functionality of such
stalwarts as sed, more/less and grep while offering complete
interactivity and a straightforward syntax. MiniTrue is freeware and is
not crippled in any manner.

    "See the MiniTrue home page at <http://www.webbuild.com/~apipkin> for
the latest versions, bug reports, etc."


OTHER FILES YOU WILL WANT:

  DOC, now available as AportisDOC -- Rick Bram's text reader for the 
         PalmPilot available from <http://www.aportis.com/products/products.html>
	 or from the PilotGear site: <www.pilotgear.com> (search for "Aportis"
	 as a company name)


  MAKEDOC.EXE -- Pat Beirne's factory for churning out DOC files.
         It's not clear whether or how MAKEDOC is still available.
	 I've heard that it is only available with the commercial
	 verison of the AportisDOC reader, though last time I looked
	 it was also available (as of Dec. 1997) from Pat Beirne's 
	 site, which used to be <http://www.corel.com/people/patb.htm>,
	 but now apparently is 
	 <http://pc-28134.on.rogers.wave.ca/makedocj.htm>.

	 You want the version on that page that is described this way:

		 "This is the Win95/Win32 version. It also contains a 16 bit version 
		 which should run in DOC. Version 8 of the .zip, version 2 of the 
		 executable. The .exe is now called 'makedoc'."


OTHER FILES YOU MIGHT WANT:

  PINSTALL.EXE -- a command-line install program for the Pilot that
         is available (as of December 1997) from Mark Pierce:
         <http://ourworld.compuserve.com/homepages/Mark_Pierce/pinstall.htm>
         or from Ray's archive under the name "Enhanced Installer Utility" at 
         <http://www.palmpilotfiles.com/SynchronizationInstallation.html>.



Trotter Hardy
thardy2@aol.com
December 24, 1997